Easync安装升级手册
版本：1.5.0
最后更新：2025/11/26
Easync安装升级手册控制中心(CC)在线方式在线安装在线升级离线方式离线安装离线升级卸载代理(Agent)安装源主机裸机目标机(RamOS)容灾目标机虚拟代理机升级命令行方式源主机裸机目标机(RamOS)容灾目标机虚拟代理机卸载卸载整机方案Agent卸载对象存储方案OBS Agent版本升级一般流程升级控制中心升级代理运行计划
控制中心(CC)
准备一台虚拟机或物理机来安装控制中心。要能连通源主机、目标机。
两种安装方式任选其一。安装过程中需要设置控制中心密码。
CentOS 7.8-7.9，Ubuntu Server 20.04 (完整OS列表请查看操作系统和平台支持列表)
4CPU, 8GB RAM, 40+GB Disk
在线方式
在线安装
控制中心支持运行在x86_64和aarch64/arm64上。下面安装命令将自动根据CPU架构安装对应的版本。
以root运行：
bash <(curl -L https://cloudock.cn/download/easync_install.sh)
根据提示完成安装。
安装命令支持以下参数：
-c 使用国内镜像源安装容器环境
-p 指定控制中心端口号。默认8443
-y 接受最终用户许可协议(EULA)
示例：
bash <(curl -L https://cloudock.cn/download/easync_install.sh) -c -p 9443 -y
在线升级
对于升级，命令同上。安装命令会执行就地升级，之前控制中心的数据和设置会保留。
bash <(curl -L https://cloudock.cn/download/easync_install.sh) -l 列出当前可供升级的最新版本。
离线方式
离线安装
在可以访问互联网的主机上下载Easync离线安装包。
根据控制中心运行的主机CPU架构不同，离线安装包分为x86_64、aarch64/arm64两个版本。
x86_64
下载方法：
点击 https://cloudock.cn/download/get_easync.php
或者
curl -L -o easync.tar https://cloudock.cn/download/get_easync.php(Linux)aarch64/arm64
下载方法：
点击 https://cloudock.cn/download/get_easync.php?a=aarch64
或者
curl -L -o easync.tar https://cloudock.cn/download/get_easync.php?a=aarch64(Linux)
将离线安装包easync.tar传输到CC主机上任意目录下，运行命令：
tar xf easync.tar && chmod +x offline-install.sh./offline-install.sh根据提示完成安装。
安装命令支持以下参数：
-p 指定控制中心端口号。默认8443
-y 接受最终用户许可协议(EULA)
示例：
sudo ./offline-install.sh -p 9443 -y
离线升级
对于版本升级，仍然可以用上述全新安装的方法。方法会执行就地升级，之前控制中心的数据和设置会保留。
也可以只下载升级包，进行升级。
bash <(curl -L https://cloudock.cn/download/easync_install.sh) -l 列出当前可供升级的最新版本。
在可以访问互联网的主机上下载Easync升级包。
根据控制中心运行的主机CPU架构不同，升级包分为x86_64、aarch64/arm64两个版本。
x86_64
下载方法：
点击 https://cloudock.cn/download/get_easync_update.php
或者
curl -L -o easync_update.tar https://cloudock.cn/download/get_easync_update.php(Linux)aarch64/arm64
下载方法：
点击 https://cloudock.cn/download/get_easync_update.php?a=aarch64
或者
curl -L -o easync_update.tar https://cloudock.cn/download/get_easync_update.php?a=aarch64(Linux)
将升级包easync.tar传输到CC主机上任意目录下，运行命令：
mkdir update; tar xf easync_update.tar -C update; cd updatechmod +x offline-update.sh; ./offline-update.sh根据提示完成安装。
卸载
当产品不再使用，删除控制中心VM即可。
由于控制中心安装依赖众多，不同平台可能依赖包、版本不尽相同，请在控制中心主机上执行以下命令，卸载或删除部分组件。
esccmgr stop
rm -rf /opt/cloudock
代理(Agent)
安装
源主机
当在源主机页面[添加源主机]时，选择安装方式
推送安装。控制中心将自动安装代理。
拉取安装。请根据页面展示步骤进行安装。
裸机目标机(RamOS)
RamOS（winpe/livecd）内置代理，无需主动安装。
注意：在运行迁移计划时，默认将自动尝试为裸机目标机升级代理程序到CC内包含的最新版。建议保持[自动检测和升级裸机内存系统中的Agent]选中。
容灾目标机
当在容灾目标机页面[添加容灾目标机]时，选择安装方式
推送安装。控制中心将自动安装代理。
拉取安装。请根据页面展示步骤进行安装。
虚拟代理机
当中备份目标页面[添加备份目标]时，将自动推送安装代理。
如果代理未安装成功，请在[虚拟代理机]页面选择主机，点击[远程安装代理]。
升级
命令行方式
命令行方式适用于所有类型主机（源主机、容灾目标机、虚拟代理机）。
如果主机上的代理可以正常连接，可以在控制中心(CC)主机上运行如下命令进行升级。如果当前代理无法连接，此方法不可用，请使用后面GUI方式。
取决于带宽和OS版本，一般需要几十秒到2分钟。
esccmgr upgrade-agent ip地址 如 esccmgr upgrade-agent 10.20.50.139
源主机
在源主机页面，选择源主机，点击[远程安装代理]。
如果使用拉取安装方式，请点击添加源主机->拉取安装，按页面提示操作。
裸机目标机(RamOS)
无需手动升级。在运行迁移计划时，默认将自动尝试为裸机目标机升级代理。建议保持[自动检测和升级裸机内存系统中的Agent]选中。
容灾目标机
在容灾目标机页面，选择主机，点击[远程安装代理]。
如果使用拉取安装方式，请点击添加容灾目标机->拉取安装，按页面提示操作。
虚拟代理机
在虚拟代理机页面，选择主机，点击[远程安装代理]。
卸载
卸载整机方案Agent
登录Agent主机，执行下面操作
Windows
进入添加删除程序，卸载Cloudock Easync Agent
删除
C:\Program Files\Cloudock目录如果报错目录无法删除，请打开磁盘管理，手动卸载Spool磁盘，再删除目录即可。
CentOS/RHEL/Oracle Linux
运行以下命令：
rpm -e easync-agentrm -rf /opt/cloudockUbuntu/Debian
运行以下命令：
dpkg -P easync-agentrm -rf /opt/cloudock
卸载对象存储方案OBS Agent
登录OBS Agent主机，执行下面操作
Windows
运行 C:\Program Files\Cloudock\Easync\obsagent\bin\uninstall.bat
删除
C:\Program Files\Cloudock\Easync\obsagent目录
Linux
运行以下命令：
sudo /opt/cloudock/easync/obsagent/bin/uninstall.shsudo
rm -rf /opt/cloudock/easync/obsagent
版本升级一般流程
在产品运行过程中，如果需要升级版本，请参见以下流程。
升级控制中心
请按控制中心升级步骤进行升级。现有控制中心中所有计划、主机等数据均将保留。
升级代理
升级源端代理
一般建议将所有代理升级到最新。
对于迁移计划，如果已经切换就绪，且近期会有切换的安排，时间可能不够重新数据同步的话，可以不对其主机升级代理。
对于容灾计划，建议停止所有计划，对源主机代理进行升级。
对于还未运行的计划，建议对其源主机升级代理，并且在运行计划时对目标机升级。
如果需要升级代理，请确保计划停止后，再进行升级。
升级目标端代理
RamOS目标机
通用模式的迁移目标机无需手动升级。运行计划时，默认将自动对目标机代理进行升级。
虚拟代理机（VA）
虚拟化模式下，支持多个计划使用同一个VA。如果需要升级VA的代理，则需要停止所有使用这个VA的计划，然后升级代理。
这意味着，如果需要升级虚拟化模式的VA，则应升级所有使用这个VA的 源主机代理。
容灾目标机
对于容灾计划，建议停止所有计划，对容灾目标机代理进行升级。
运行计划
升级完毕后，正常运行计划即可。